home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 November / Software of the Month Club 1996 November.iso / mac / Software Research Institute-SRI / Education / CalConvert 2.2 FAT / CalConvert FAT / CalConvert FAT.rsrc / TEXT_5000.txt < prev    next >
Encoding:
Text File  |  1996-07-03  |  8.5 KB  |  130 lines

  1.  
  2.                        CalConvert documentation
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  Version 2.2.1                                                                                                      July 1996 
  10.  
  11. ┬⌐1996 Alessandro Levi Montalcini   Technical support, permissions, suggestions:
  12. C.so Re Umberto 10                          Internet email: alm@torino.alpcom.it
  13. 10121 Torino                                   ftp://ftp.alpcom.it/software/mac/LMontalcini
  14. Italy                                                ftp://ftp.alpcom.it/software/mac/LMontalcini/alm.html
  15.  
  16. Binary Software, Inc.                       Orders and registrations only:
  17. 2118 Wilshire Blvd Suite 900           Phone: (800) 8-BINARY (824-6279)
  18. Santa Monica, CA 90403                   or: (310) 449-1481
  19. United States of America                   Fax: (800) 555-7217 or (310) 449-1473
  20.                                                         Internet email: sales@binarysoft.com
  21.                                                         CompuServe email: 74220,3377
  22.                                                         America Online email: BINARY SW
  23.                                                         ftp://users.aol.com/binarysw/
  24.                                                                                                                                             
  25.  
  26. ΓÇó Shareware: $10
  27. Γùè  This program is distributed as shareware: if you use it please honor the shareware system by sending $10 U.S. to Binary Software at the address above. You can email, fax, snail-mail, or call. When registering please specify the name and version of this program as well as your name, mailing address, email address, phone number, fax number, and your credit card number and expiration date (we accept Visa, MasterCard, American Express, and Discover). You can also pay with a check, money order, or cash.
  28. Γùè  Binary Software is only collecting the registrations on my behalf; please contact me directly by email for any information, suggestion, permission, or request about this software. If you want to send non-U.S. cash or any other material including software, books, magazines, CD-ROMs or any hardware, please send it to me at my Italian address. If you do so, however, you should also notify me by email because I only receive my snail mail once per month.
  29. Γùè  If you canΓÇÖt afford to register you may still want to send Binary Software your name, address and email address so they can send you new product announcements and other special offers.
  30. Γùè  Site licenses and group discounts are available for 5 or more registrations. Please check my ftp site or send email for more information.
  31. Γùè  Please register: your support is the only way for me to keep working on cool shareware programs.
  32.  
  33. ΓÇó Introduction
  34. Γùè  CalConvert is a small shareware utility that does integer arithmetic calculations and converts integer values to different bases (decimal, hexadecimal, binary, octal or any custom base between 2 and 32) or to an OSType (a sequence of four ASCII characters). The conversion may be signed or unsigned (you can always enter a signed value, it gets converted to unsigned if needed); the result may be interpreted either as a word (2 bytes) or as a long word (4 bytes). Version 2.0 sports a new clickable bit field display for easy bit-by-bit manipulations. The Return and Enter keys start the conversion; Tab, shift-Tab and the four arrow keys have their usual meanings.
  35.  
  36. ΓÇó Configuration
  37. Γùè  Choosing the ΓÇ£FieldsΓÇ¥ item from the ΓÇ£OptionsΓÇ¥ menu brings up a configuration dialog that can be used to fully customize CalConvert. CalConvert can show up to 8 fields; each field contains either a mathematical expression, a sequence of 1 to 4 characters (OSType) or an integer number in any base from 2 to 32.
  38. Γùè  Version 2.0 comes with Font and Size menus that can be used to change the windowΓÇÖs look and size.
  39.  
  40. ΓÇó The calculator
  41. Γùè  You may enter mathematical or logical expressions in fields labeled ΓÇ£MathΓÇ¥, i.e. things like ΓÇ£(12*(128-$20))<<2+2^8ΓÇ¥; the result is shown in all the other fields of the window when you press Return or Enter or click the ΓÇ£=ΓÇ¥ button. If the expression canΓÇÖt be parsed correctly, CalConvert beeps and all other fields are set to zero. The next paragraphs explain the syntax and operators you may use in your mathematical expressions.
  42.  
  43. ΓÇó Syntax of the math field
  44. Γùè  xxx (x=0-9) is a number
  45. Γùè  $xxx (x=0-9,A-F) is an hexadecimal number
  46. Γùè  -xxx, -$xxx, $-xxx are negative numbers
  47. Γùè  '(' and ')' can be used as usual, nesting allowed
  48. Γùè  spaces are allowed between numbers and operators
  49. Γùè  no spaces are allowed inside numbers or operators
  50. Γùè  all numbers are interpreted as 32-bit signed integers
  51.  
  52. ΓÇó Order of operators
  53. Γùè  Operators in the upper lines are calculated first.
  54. Γùè  Operators in the same line are calculated sequentially.
  55.     
  56.    ^   **
  57.    *   /   :   %   <<  >>
  58.    &   |   \   AND OR  XOR
  59.    +   -
  60.    =   ==  !=  <>  <   >   <=  >=
  61.  
  62. ΓÇó Arithmetic operators
  63.  
  64.   +     add
  65.   -     subtract
  66.   *     multiply
  67.   /     divide
  68.   :     divide
  69.   %     remainder
  70.   ^     power
  71.   **    power
  72.  
  73. ΓÇó Logical operators
  74.     (return 1 if true, 0 if false)
  75.  
  76.   =     equal to
  77.   ==    equal to
  78.   !=    not equal to
  79.   <>    not equal to
  80.   <     less than
  81.   >     greater than
  82.   <=    less or equal
  83.   >=    greater or equal
  84.  
  85. ΓÇó Bitwise operators
  86.  
  87.   <<    bit shift left
  88.   >>    bit shift right
  89.   &     bit and
  90.   AND   bit and
  91.   and   bit and
  92.   |     bit or
  93.   OR    bit or
  94.   or    bit or
  95.   \     exclusive or
  96.   XOR   exclusive or
  97.   xor   exclusive or
  98.  
  99. ΓÇó Version history
  100. Γùè  2.2.1 - Recompiled with CodeWarrior 9 and updated documentation.
  101. Γùè  2.2 - Fixed a bug in the parser that caused bad prioritization of the operators for some complex expressions that didnΓÇÖt use parenthesis (thanks to Paolo Sasso for finding out the problem).
  102. Γùè  2.1 - Uses the color utilities pattern as a background pattern under System 7.5 or later. You can set the utilities pattern by holding down the option key inside System 7.5ΓÇÖs Desktop Patterns utility.
  103. Γùè  2.0 - Added a clickable bit-by-bit representation, font and size menus, ΓÇ£long wordΓÇ¥ and ΓÇ£unsignedΓÇ¥ check boxes and an ΓÇ£evaluateΓÇ¥ button; most of the interface code was rewritten to make the CalConvert window a configurable stand-alone code module.
  104. Γùè  1.2.3 - CalConvert now refuses exponents larger than 32.
  105. Γùè  1.2.2 - Made the fields dialog movable.
  106. Γùè  1.2.1 - Cleaned up the code and updated documentation.
  107. Γùè  1.2 - Recompiled as a fat binary, runs native on Power Macs.
  108. Γùè  1.1 - Removed System 7 dependance and custom window definition.
  109. Γùè  1.06 - Added online help, changed menu keys to follow Apple guidelines.
  110. Γùè  1.05 - Fixed incoherent behavior of the ΓÇ£FieldsΓÇ¥ dialog.
  111. Γùè  1.04 - Changed name to CalConvert.
  112. Γùè  1.03 - First shareware version with arithmetic parser.
  113. Γùè  1.02 - First public release as QuickConvert.
  114. Γùè  1.01 - Menus added, still looks like a quick hack.
  115. Γùè  1.0 - Written for my personal use only, very poor interface.
  116.  
  117. ΓÇó Distribution
  118. Γùè  This software is ┬⌐1995-96 Alessandro Levi Montalcini. It can be freely distributed as long as it is not modified and thereΓÇÖs no charge for it, but it may not be included in any commercial package without my consent.
  119. Γùè  All online services and bulletin boards may make it available to their users at no charge other than the normal connection fees.
  120. Γùè  All non-profit user groups may distribute it at no charge.
  121. Γùè  All magazines may publish it on floppy disk or CD-ROM without asking me first, as long as I get a copy of the issue containing my software.
  122. Γùè  All CD-ROM shareware collections and CD-ROM magazines may include it without my prior consent, as long as I get either a copy of the CD-ROM or an offer to buy the CD-ROM at a discounted price.
  123. Γùè  All redistribution companies such as Pacific HiTech, AMUG, Celestin or Educorp may distribute it, as long as I get a copy of each media containing my software and a catalog of the companyΓÇÖs offerings (where applicable).
  124. Γùè  You may find the latest version of all my shareware and freeware programs by anonymous ftp to ftp.alpcom.it, inside the /software/mac/LMontalcini directory. The ALM Share and ALM Free packages, which contain most of my stuff and can be registered at a very low price, are also available there.
  125.  
  126. ΓÇó Disclaimer
  127. Γùè  This software should never cause any damage, but youΓÇÖre using it at your own risk. As an independent software developer, I can make no warranties whatsoever on it.
  128.  
  129. ΓÇó Have fun!
  130. Γùè  And donΓÇÖt forget to register your shareware, so that more cool inexpensive utilities can see the light in the future.